interface . dtd 

rules for describing an object interface in xml 



< ! KTiKMENT parameter 
< IATTLIST parameter 



< i ELEMENT method 
<! ELEMENT object 



*PCDATA> 

type 
> 



CDATA 



fcREQUIBED 



(#PCDATA, (parameter) +) > 
(# PCDATA, (method) -h) > 



interface. h 

example object interface in c 



/* object */ 

typedef struct Stream { 
int id; 

}; 



/* methods */ 

void StreamPlay (int id, int speed) ; 
void St reams top (int id) ; 



int erf ace. xml 

the same object in xml using rules of interface . dtd 



<ob j ect >Stream 

<method>Play 

< /method* 
<method>Stop 



<pararaeter type- » int ">id</parameter> 
parameter type- » int ">speed< /parameter* 



<object> 



< /methods 



<parameter type-" int ">id< /parameter* 



call . dtd 

rules for describing a c function call in xral 



< ! ELEMENT parameter 
< ! ATTLIST parameter 



< 1 ELEMENT method 
< 1 ELEMENT ofa j ect 
< I ELEMENT call 



#PCDATA> 
value 



CDATA 



#REQUIRED 



(#PCDATA, (parameter) +) > 
(#PCDATA) > 

(object, method) > 



controllers 

example controller command in c 



StraamPlay (OxOlae, 500) ; 



call . xml 

the same command in xml using call. dtd 
example to play a stream 



<call> 

<obj ect>Streaxn</object> 
<method>Play< /method> 
<parameter value- »01ae">id< /parameter 
i <parameter value- » 500 «>speed</parameter> 



call . dtd 

rules for describing a c function call in xml 



< i ELEMENT parameter #PCDATA> 

< 1 ATTLIST parameter 

value CDATA #REQUXRED 

> 

< i ELEMENT method (#PCDATA, (parameter) +) > 

< ! ELEMENT ob j ect (#PCDATA) > 

<! ELEMENT call (object, method) > 



interface . dtd 

rules for describing, an object interface in xml 



< 1 ELEMENT parameter #PCDATA> 
< ! ATTLIST parameter 

type CDATA ' #R£QUX2HD 

> 

< 1 ELEMENT method (#PCDATA, (parameter) +) > 

< ! ELEMENT obj ect (# PCD ATA, (method) +) > 



interface . xml 

this document describes various CE services offered -a 
subset of the whole CE space. 



<?xml version-"! . 0"?> 

<lDOCTYPE interface SYSTEM "interface .dtd" > 
<ob ject>Stream 



(*- [ of i) 



<meChod>Open 

parameter type- » int " >id< /parameters 
<parameter type- "int 11 >channel</parameter> 

</tnetbod> 
<method>Close 

parameter type-" int ">id< /parameter > 

</method> 

</object> 

<ofa j ect>Control 

<metfaod>Set 

<parameter type- » int " >id< /parameters 
^parameter type-" int" >level</TDarameter> 

</method> 

</object> 

<obj ect>Storage 

<method>Open 

parameter type=" int ">id< /parameter > 
parameter type-- int ">cfaannel< /parameter 

</method> 
<method> Record 

parameter type-»int">id</parameter> 

</methxxi> 
<method>Play 

parameter type*" int «>id< /parameter > 
parameter type-" int «>apeed< /parameter 

</method> 
<metliod>Stop 

<pararaeter type-" int ">id</parameter> 
</raethod> / 

<method>Cldse 

parameter type- ■ int • >id< /parameter 

</method> 

</object> 

<ob j ect>Display 

<method>Open 

<parameter type-" int ">id< /parameter > 
parameter type- » int «■ >channel</pararaeter> 

</method> 
<method> Render 

<parameter type- « int " >id< /parameter* 

</method> 
<method>BlanJc 



APPWW 2, eofJTp 

Ciz or 3) 



parameter type- "int»>id< /parameter* 

</method> 

<method>Control 

parameter type- »iat t, >id< /parameter > 
<parameter type- n iat ,, >cid</paramacer> 
parameter type- n int°>level</paraiaeter> 

</method> 
<method>Cloee 

<parameter type=»int*>id< /parameter > 

</method> 

</obj ect> 



<I 

otr.xml 



an xml representation of one touch record 
c representation: 

Streamopen (100, 2);/* play a stream (pushed by satellite feed) */ 
StorageOpen (24, 2);/* open a storage service •/ 
StorageRecord (24);/* record the stream */ 



<?xml version- ' 1 .0"?> 

<!DOCTYPE interface SYSTEM "call.dtd"> 
<call> 

<object>Stream<object> 

<method>Open</method> 

<parameter value="100">id</parameter> 
<parameter value= ,, 2 M >channel</parameter> 

</call> 
<call> 

<object>Storage</object> 

<method>Open</method> 

<parameter vaIue= n 100 H >id</parameter> 
<parameter vaiue=' , 2 ,, >channel</parameter> 

</ca!l> 
<call> 

<object>Storage</object> 

<method>Record</method> 

<parameter value=" 1 00">id</parameter> 

</ca!l> 



f4% ac. 



(document_file, doo) 

' - ■<loounxcnt - _filo^5cfvcf^ > honicdtd > scrver_ 

• v c_coram*n d*< — coranumd_string_ J> , 

•ervicca^hotne (client, av, lighting, cornrni, hvac, utility, security, appliance, convenience,,) 

+ xzni_tttility (dovmload^DTD^fil&O 

client (acknowledge, attention, error, post_messagc, sound, stDp^schedulo, stop_aIl„) 
i s oun d (alarm, ring, buzz,,) 
i iiir vcr_av (source, sink) 

source (scrvic*_ld, media, rats, protocol, stream_fbrmat. controls .jgen, controls_av„) 

+ sink (servico_td, moriia, ram, protocol, ttream_fbrroat. controls*) 

+ service Jd (urU 

media, (tpt.stream, ram, disk, tape*.) 
+ disk (name, number,.) 



-> protocol (61883/1394, UDP/IP/EtfaerneO 

h 61883/1394 (isoch_ch_no) 

t iinism^fniiiinr (video, audio,,) 

» video (dv, mpeg2tpt, dsstpt, mpeg2pes, mpeg 1 080%-tpt,) 
audio (mpeg3, ao-3, mtdi„) 
i controls gen (ping. process_irxfb, setup,,) 
» controla_av (flow_ control, twin, timcr_ record, control,,) 
i proooM^infb (s/w_ Id, h/w_id) 

+ ■ h/w^id (ser_oo, model, class,,) 

+■ s/w_id (ser_no. exe_name, version*,) 
> (clocks) 

+— clock (hours, minutes, seconds) - - 
©^record (tune, flow_controI) 
-flow_control (play, stop, goto, record^,) 
play (time _par&ms) 
»■■ rec or d (time __params) 
i (aend_epg, channel^) 

+— --channel (number, id* tnnejMnma^) 

■ - t ime ^psxanis (bow, start, duration, endQ 
decontrol (display, acoustic) 

-•——display (brightness, contrast, color/tint, horix_sixc vert_sixe„) 
i ac oustic (volume, bass, treble, halanra. fade,) 



Lighting (sensors, lights. send_epg) 

i union (living room. sky M ) 

f lights (rooma^up, rocms_down, yard*,) 

J_up (bodl, bod2, bed3. bcd4 M ) 
-roccu^down (family, ki t c hen , living, dining, soho, garage,,) 
■■yard (flout, back) 

(lamp, dimmer,,) 



-comms (nrtman, intercom , telco.) 

i Miiiiniii(acnd_davicejliet, sead^ccaflguraiion, *end_snmp__rnib„) 



hvac (eemrola gen- eontrola_hvaa,,) 

ijnrao (a/c, heat, temp, humidity,) 
(low, high, hysteresis^) 
inility(mtttr«, on<ergy_mgmO 

mctera (water, gae, electric^) 

+ wamr«?vaiue>, gas<value>, electrio<vaiue> 

a ccurity(3cnsars, send_apg, alarm,,) 
^"^^sensors (peripheral, motion^) 

peripheral (roomsjup, rooma_dawn*,) 
-■matron (raoms^down, yard^,) 

+ appliances (microwave, range, oven, fridge, freezer, coffee, toaster, washer, dryer, water. *«*£er„) 

+ microwave (send^cpg. controls,.) 

+ fridge (tempw,) 

(temp) 

(window, curtam_open, doer/gate, pool/spa, bath, fountain, lift,) 
» cmta in^open-<vaiue> 
(n 
Ueage - 



existing implementation: 

void DeviceCALCommand (int command) { 



/* 

create CM, formatted byte string to represent this object/method 

and output to the wire 

*/ 

CreateCALPormattedByceString (command);/* different for every 

protocol * / 

SendCALByteStringO ; /* different for every protocol */ 



wrapping the XML Service API call: 
void DeviceCALCommand (int command) { 
/* 

replace CAL implementation with calls to the XML ServiceAPI 
CreateXMLMessage (command) ; /* alwaya ^ same ./ 

SendXMLMessage () ; /* always the same */' 



consumer (document_f lie , doc) 

+ - - * - document_f ile< server_home . dtd, aerver_auto . dtd> 

+ doc (3ervice3_home, server_auto, server_saraeung_web_3ite , , avc_commanda , cal_commands , , ) 

+ servicea^home (xml_utility, client, aerver_av, lighting, comma, hvac, utility, security, 

appliances , convenience , , ) 



+ xml_utility (download_DTD_£ile, , ) 

+ client (acknowledge, attention, error, post_measage , sound, atop_achedule , stop_all,,) 

+ sound (alarm, ring, buzz,,) 

+ server_av (controla_gen, source, sink) 

+ controls_gen (ping, proceaa_info, setup,,) 

+ proceaa_info (s/w_id, h/w_id) 

+ h/w_id (ser_no, manuf, model, class,,) 

+ a / w_id ( s er_ no , exe_ name , vers ion , , ) 

+ setup (clock,,) 

t clock (hours, minutea, seconds) 

+ source (service_id, media, rate, protocol, atream^format. controls_av, , ) 

+ sink (service_id, media, rate, protocol, stream_format, controls_av, , ) 

+ service_id (url,,) 

+ media (tpt_stream, ram, disk, tape,,) 

+ disk (name, number,,) 

+ rate<value> 

+ protocol (61883/1394, UDP/IP/Bthemet, , ) 

♦ 61883/1394 (isoch_ch_no) 

+ stream_£ormat (video, audio,,) 

+ video (dv, mpeg2tpt, dsstpt, mpeg2pea, mpegl080i-tpt, ) 

+ audio (mpeg3, ac-3, raidi, , ) 

+ controls^ av (f low_control, tune, timer_record, ui_control , , ) 

+ timer record (tune, f low_control) 



+ flow_control (play, stop, goto, record,,) 

+ play (timejparams) 

+ record (timejparams) 

+ timejparams (now, start, duration, end,,) 




+ tune (send_epg, channel,,) • 

+ channel (number. Id. time _params , , ) 

+ ui_control (display, acoustic) 

+ display (brightness, contrast, color/tint, horiz_size, vert_size, , ) 

+ acouatic (volume, bass, treble, balance, fade,) 



+ lighting (sensors, lights, send_epg) 

+ sensors (living-room, sky, , ) 

+ lights (rooms_up, rooma_down, yard,,) 

+ rooms_up (bedl, bed2, bed3, bed4,,) 

+ bedl (lamp, dimmer,,) 

+ dimmer <value> 

+ rooms_down (family, kitchen, living, dining, soho, garage,,) 

+ yard (front, back) 

+. comms (homehub, intercom, telco, ) 

+ homehub (send_device_list, send_con£iguration, send_snmp_mib, , ) 

intercom () 

+ telco () 

+ hvac ( control s_gen, controls_hvac, , ) 

+ controls_hvac (a/c, heat, temp, humidity,) 

+ temp (low, high, hysteresis,,} 

+ utility (meters, energy_mgmt , , ) 

+ meters (water, gas, electric,,) 

+ water<value>, gas<value>, electric<value> 

+----security(sensors, send_epg, alarm,,) 

+- sensors (peripheral, motion,,) 

+ peripheral (rooms_up, rooras — down , , ) 

+ motion (rooms_down, yard,,} 

+ appliances (microwave, range, oven, fridge, freezer, coffee, toaster, washer, dryer, 



+ microwave (send_epg, controls,,) 

+ fridge (temp,,) 

+ water_heater (temp) 

+ convenience (window, curtain_open, door/gate, pool/spa, bath, fountain, lift, jacuzzi,,) 

+ curtain_open<value> 

+ server_auto (message, serve r_auto_ford_ explorer_98, , ) 

+ 3erver_auto_ford_explorer_98 (mileage, maintenance,, ) 



water heater, , ) 





+ mileage <data> 

+ maintenance <data> 

3erver_9amsung_web_si te ( message , service , help , , , ) 



h a vc — commands < . . . command_string. , . > 

+ service_id <url, , ) 



+* - - **cal_commands< . . . command string. . . > 
+ aervice_id (url,,) 



